GGGGLLLL____QQQQUUUUAAAADDDD____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____SSSSGGGGIIIISSSS, GGGGLLLL____QQQQUUUUAAAADDDD____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444____SSSSGGGGIIIISSSS, or
Each element is a single value, a color index. The GL converts
it to fixed point (with an unspecified number of zero bits to
the right of the binary point), shifted left or right depending
on the value and sign of GGGGLLLL____IIIINNNNDDDDEEEEXXXX____SSSSHHHHIIIIFFFFTTTT, and added to
GGGGLLLL____IIIINNNNDDDDEEEEXXXX____OOOOFFFFFFFFSSSSEEEETTTT (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr). The resulting index is
Each element is a luminance/alpha pair. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green, and
blue. Each component is then multiplied by the signed scale
factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
clamped to the range [0,1] (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
If an application wants to store the texture at a certain resolution or
in a certain format, it can request the resolution and format with
_i_n_t_e_r_n_a_l_f_o_r_m_a_t. The GL will choose an internal representation that
closely approximates that requested by _i_n_t_e_r_n_a_l_f_o_r_m_a_t, but it may not
match exactly. (The representations specified by GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE,
GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, and GGGGLLLL____RRRRGGGGBBBBAAAA must match exactly. The numeric
values 1, 2, 3, and 4 may also be used to specify the preceding
representations.)
Use the GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD target to try out a resolution and format.
The implementation will update and recompute its best match for the
requested storage resolution and format. To query this state, call
ffffggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr. If the texture cannot be accommodated, texture
state is set to 0.
A one-component texture image uses only the red component of the RGBA
color from _p_i_x_e_l_s. A two-component image uses the R and A values. A
three-component image uses the R, G, and B values. A four-component
image uses all of the RGBA components.
The mapping of components from the canonical RGBA to the internal storage
formats that begin with GGGGLLLL____DDDDUUUUAAAALLLL____ and GGGGLLLL____QQQQUUUUAAAADDDD____ needs to be clarified.
There are three cases. The first case is for the GGGGLLLL____DDDDUUUUAAAALLLL____ formats that
are groups of GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, and GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY. The R value goes
to the first group while the A value goes to the second group. The
second case is for the GGGGLLLL____DDDDUUUUAAAALLLL____ formats that are groups of
GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA. The R and G values go to the first group while the B
and A values go to the second group. The third case is for the GGGGLLLL____QQQQUUUUAAAADDDD____
formats. The R value goes to the first group, the G value to the second
group, the B value to the third group, and the A value to the fourth
group.
Normally ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD is synchronous: OpenGL executes a ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD
command in the order it is issued in the OpenGL command stream. Calling
ffffggggllllEEEEnnnnaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX causes subsequent
ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD commands to be asynchronous as defined by the SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc
extension. An asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD command samples the OpenGL
state vector at the point in the OpenGL command stream where the command
is issued, but the results of the command (e.g. availability of texels
for use in rasterization) do not happen until some unspecified time in
the future. In particular, the order of the asynchronous command
relative to other OpenGL commands issued later in the command stream is
undefined. An implementation may choose to execute asynchronous commands
in parallel with the normal command stream or at some convenient time in
the future.
Calling ffffggggllllDDDDiiiissssaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX restores the
default synchronous behavior for subsequent ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD commands. It
does not affect any pending asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands, or wait
for their completion.
When an asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD command is issued, it is associated
with the current value of GGGGLLLL____AAAASSSSYYYYNNNNCCCC____MMMMAAAARRRRKKKKEEEERRRR____SSSSGGGGIIIIXXXX as defined by the
SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc extension. A program can determine if an asynchronous
ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD command has completed by using the ffffggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or
If a convolution filter changes the __width of the texture (by
processing with a GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE of GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE, for
n
example), the _w_i_d_t_h must 2 +2(border), for some integer n, after
filtering.
3. RGBA components may be multiplied by GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____cccc____SSSSCCCCAAAALLLLEEEE,
and added to GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____cccc____BBBBIIIIAAAASSSS, if enabled. See
4. Color component replacement by the color table specified for
GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled. See ffffggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
5. Transformation by the color matrix. See ffffggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee.
6. RGBA components may be multiplied by GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____SSSSCCCCAAAALLLLEEEE,
and added to GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____BBBBIIIIAAAASSSS, if enabled. See
7. Color component replacement by the color table specified for
GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled. See ffffggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
The texture image can be represented by the same data formats as the
pixels in a ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss command, except that GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT cannot be used. ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr
modes affect texture images in exactly the way they affect ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT is part of the EEEEXXXXTTTT____aaaabbbbggggrrrr extension, not part of the core GL
command set. If GGGGLLLL____EEEEXXXXTTTT____aaaabbbbggggrrrr is included in the string returned by
ffffggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS, extension EEEEXXXXTTTT____aaaabbbbggggrrrr
is supported by the connection.
GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD may be used only if the GL version is 1.1 or greater.
Internal formats other than 1, 2, 3, or 4 may be used only if the GL
version is 1.1 or greater.
In GL version 1.1 or greater, _p_i_x_e_l_s may be a null pointer. In this case
texture memory is allocated to accommodate a texture of width _w_i_d_t_h. You
can then download subtextures to initialize the texture memory. The image
is undefined if the program tries to apply an uninitialized portion of
the texture image to a primitive.
Formats GGGGLLLL____BBBBGGGGRRRR, and GGGGLLLL____BBBBGGGGRRRRAAAA and types GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and
GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV are available only if the GL version is
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD or
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log _m_a_x, where
2
_m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not 1, 2, 3, 4, or one
of the accepted resolution and format symbolic constants.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is less than 0 or greater than 2 +
n
GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or if it cannot be represented as 2 + 2(border) for
some integer value of _n.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD is executed between
the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not
GGGGLLLL____RRRRGGGGBBBB.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t
is not GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRRAAAA or GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT.
GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX is enabled
and the number of asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that have been issued
but not queried (using ffffggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or ffffggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX) exceeds